home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / system / swell100.zip / SWELL.DOC < prev    next >
Text File  |  1989-07-06  |  33KB  |  994 lines
  1.  
  2.  
  3.  
  4.  
  5.                                     Contents
  6.  
  7.  
  8.                   1  Abstract  . . . . . . . . . . . . . . . . . . . 1
  9.                   2  Introduction  . . . . . . . . . . . . . . . . . 1
  10.                   3  Usage . . . . . . . . . . . . . . . . . . . . . 1
  11.                      3.1  SWELL.EXE  . . . . . . . . . . . . . . . . 1
  12.                      3.2  SwellCFG.EXE . . . . . . . . . . . . . . . 2
  13.                      3.3  MemMap (MM.EXE)  . . . . . . . . . . . . . 3
  14.                   4  Where did my TSR go?  . . . . . . . . . . . . . 4
  15.                   5  Turbo Trouble . . . . . . . . . . . . . . . . . 5
  16.                   6  Possible Uses . . . . . . . . . . . . . . . . . 5
  17.                      6.1  Lotus 123  . . . . . . . . . . . . . . . . 5
  18.                      6.2  MAKE.EXE / Microsoft C Compiler  . . . . . 5
  19.                      6.3  Text editor with a Compiler  . . . . . . . 5
  20.                      6.4  Debuggers  . . . . . . . . . . . . . . . . 6
  21.                      6.5  Bulletin Board Systems (BBS) . . . . . . . 6
  22.                   7  Problems  . . . . . . . . . . . . . . . . . . . 6
  23.                      7.1  Special Situations . . . . . . . . . . . . 7
  24.                      7.2  Communications Programs  . . . . . . . . . 7
  25.                      7.3  Local Area Networks (LANs) . . . . . . . . 7
  26.                   8  Disclaimer  . . . . . . . . . . . . . . . . . . 8
  27.                   9  License . . . . . . . . . . . . . . . . . . . . 8
  28.                      9.1  Registered Version . . . . . . . . . . . . 8
  29.                      9.2  Demonstration Version  . . . . . . . . . . 8
  30.                   10  Registration . . . . . . . . . . . . . . . . . 9
  31.                      10.1  Prices  . . . . . . . . . . . . . . . . . 9
  32.                      10.2  Order Form  . . . . . . . . . . . . . .  10
  33.                   11  For more information:  . . . . . . . . . . .  11
  34.  
  35.                Index                                                13
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.           1  Abstract
  44.  
  45.  
  46.           SWELL transparently swaps a program  out of memory onto disk when
  47.           a  child  program  is loaded.  This allows a program to run other
  48.           programs even  if  there  is  not  enough  RAM for them to occupy
  49.           simultaneously.
  50.  
  51.  
  52.           2  Introduction
  53.  
  54.  
  55.           This   program   alleviates   memory  constraints  under  certain
  56.           conditions.  The following    example  will help illustrate: Many
  57.           word  processors  (Sprint,  WordPerfect)  come   with  conversion
  58.           utilities that run externally.    If you have 300k of free memory
  59.           and your word  processor  uses  250k,  this  leaves  50k  for the
  60.           conversion utility to operate.  It may not be enough!
  61.  
  62.           When SWELL is active, it will swap the word processor session out
  63.           to disk before  loading  the conversion utility (leaving the full
  64.           300k free for the conversion  utility to operate) then reload the
  65.           wordprocessing session  at the completion of the conversion.  The
  66.           wordprocessor will not be aware that it was put into  limbo while
  67.           the conversion utility was running.
  68.  
  69.           The  results  are  obvious: SWELL can allow programs to work when
  70.           they would not work before.
  71.  
  72.  
  73.           3  Usage
  74.  
  75.  
  76.           3.1  SWELL.EXE
  77.  
  78.           SWELL  is  a  TSR  (Terminate  and  Stay  Resident) program  that
  79.           requires  no  parameters  on  the  command line.  If not  already
  80.           installed, SWELL will remain  in  memory after you start it.  The
  81.           registered version  of SWELL uses approximately 9K of memory, the
  82.           demonstration version uses approximately 48k.
  83.  
  84.           SWELL will use the root directory of the drive you loaded it from
  85.           for  its swap files unless you specify  one  of  two  environment
  86.           variables as follows:
  87.  
  88.                SET TMP=x:\path
  89.           or
  90.                SET SWELL=x:\path
  91.  
  92.           Both  the  TMP  and  SWELL  environment variables have  the  same
  93.           effect.  If both are  specified, SWELL takes precedence over TMP.
  94.           If you have extended, EMS or XMS memory,  you  can  create  a RAM
  95.           disk and point TMP, or SWELL to it.  Note  that  SWELL only looks
  96.           for these variables when it is loaded into  memory;  Changing TMP
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.           or  SWELL  afterwards  will NOT change the path where SWELL swaps
  104.           memory.  Performance is so high with a  ram  disk  that  you will
  105.           probably not notice any swapping occurring.
  106.  
  107.           If you have  any  other  TSR  programs, you will probably want to
  108.           load them before SWELL (this is discussed further in section 4.)
  109.  
  110.           3.2  SwellCFG.EXE
  111.  
  112.           SwellCFG Allows  you to view and/or change certain SWELL options.
  113.           SwellCFG will only work  if  SWELL  has  been loaded into memory.
  114.           Starting this  program with no parameters brings up the following
  115.           help screen:
  116.  
  117.           █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  118.           █ SwellCFG             (C) 1989 Peter Fitzsimmons 06-03-89 █
  119.           █                                             Version 1.01 █
  120.           █ Usage:   SWELLCFG  [/d] [/v on|off] [/1] [/s] [/a] [/u]  █
  121.           █                    [/b on|off]                           █
  122.           █                                                          █
  123.           █ Purpose: Display/Modify SWELL's (the SWapper shELL)      █
  124.           █          operating characteristics.                      █
  125.           █ Options: /d - Display current status (no changes).       █
  126.           █          /v - turn verbose flag off (quiet mode) or on.  █
  127.           █          /1 - suspend once : don't do any swapping       █
  128.           █               for the next program that is loaded.       █
  129.           █          /s - suspend (until reactivated with /a).       █
  130.           █          /a - activate.                                  █
  131.           █          /u - uninstall (remove SWELL from memory).      █
  132.           █          /b - engage/disengage support for certain       █
  133.           █               Borland products.                          █
  134.           █ Example: SWELLCFG /a /v off                              █
  135.           █          would ensure that SWELL is active, and is in    █
  136.           █          quiet mode.                                     █
  137.           █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  138.                           Figure 1: The SwellCFG Usage Box
  139.  
  140.           SwellCFG communicates with SWELL  through  the  SWELL Application
  141.           Programming Interface (SAPI).   Registered  users  receive  the C
  142.           source code (Microsoft/Turbo) for SwellCFG, as  well  as complete
  143.           documentation on SAPI.  SwellCFG takes the following command line
  144.           parameters, in any order:
  145.  
  146.           /d -      Displays the status of the verbose  flag,  the "suspend
  147.                     once" flag, and the suspended flag.
  148.           /v -      Changes the status of the verbose flag.  When ON, SWELL
  149.                     will print messages  when  it is swapping memory out to
  150.                     disk, loading programs, and swapping data from  disk to
  151.                     memory.   When loading a program, SWELL will report how
  152.                     many bytes of RAM it has saved you so far.   Verbose on
  153.                     is useful when debugging your  system,  or  if  you are
  154.                     curious about SWELL's  effectiveness.  With the verbose
  155.                     flag  OFF,  SWELL  is in quiet mode; it will only print
  156.  
  157.  
  158.  
  159.  
  160.                                         - 2 -
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.                     messages during  an  error  condition  (ex:  swap  disk
  168.                     full).  The default is OFF.
  169.           /s -      This  option will suspend SWELL from swapping  programs
  170.                     out to disk.  It will NOT stop it from swapping  IN any
  171.                     programs  it  had  swapped out to disk  before  it  was
  172.